主力行為指標

介面描述

取得BTC或ETH在特定時間範圍內的，因主力動作可能影響到價格趨勢的特色指標資料。

使用情境：

• 適用於對BTC和ETH的價格大趨勢判斷参考
• 適用於辨識主力行為對價格的影響和整體價格趨勢走向判斷

資料更新頻率：每5分鐘更新一次

請求 URL

• 方法：POST
• 路徑：/open/v1/indicator/getPriceMarketList

點數消耗

• 消耗點數：2

前置條件

取得 vsTokenId

條件	說明	取得方式
已有 vsTokenId	直接使用快取的 vsTokenId，無需重複查詢	上下文自動提取
未有 vsTokenId	呼叫 POST /vs-token/list 介面取得	前置介面呼叫

請求參數

參數透過請求體（Body）以 JSON 格式傳遞。

參數名	類型	必需	描述
vsTokenId	long	是	代幣 ID
startTime	long	否	開始時間（毫秒時間戳）
endTime	long	是	結束時間（毫秒時間戳）

回應欄位

僅展示 data 陣列內每個物件的欄位結構：

欄位	類型	實際回傳類型	描述
vsTokenId	long	string	代幣ID
symbol	string	string	代幣符號
date	long	long	時間（毫秒時間戳）
priceMarketType	integer	integer	價格趨勢（1：上漲，2：下跌）

欄位業務含義

欄位	業務含義	使用建議
priceMarketType	價格趨勢標記	1表示上漲阶段，2表示下跌阶段，用於判斷當前價格走勢

列舉值說明

priceMarketType - 價格趨勢

值	含义
1	上漲
2	下跌

請求範例

{
    "vsTokenId": 1,           // 代币 ID
    "startTime": 1770825600000, // 开始时间（时间戳）
    "endTime": 1773417600000    // 结束时间（时间戳）
}

cURL 範例（Linux/macOS）

curl --location --request POST 'http://${host}/api/open/v1/indicator/getPriceMarketList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "startTime": 1770825600000,
    "endTime": 1773417600000
}'

cURL 範例（Windows CMD）

curl --location --request POST "http://${host}/api/open/v1/indicator/getPriceMarketList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"startTime\": 1770825600000,    \"endTime\": 1773417600000}"

成功回應範例

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",                     // 代币ID
            "symbol": "BTC",                      // 代币符号
            "date": 1773158400000,                // 时间
            "priceMarketType": 1                   // 价格趋势（1：上涨，2：下跌）
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "date": 1773149400000,
            "priceMarketType": 1
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "date": 1773149100000,
            "priceMarketType": 1
        }
        // ... 更多数据省略
    ],
    "requestId": "xxx-xxx-xxx"
}